package com.example.demo.mapper;

import com.example.demo.entity.Banner;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 轮播图Mapper
 *
 * @author 叮当猫的百宝箱
 * @since 1.0
 */
public interface BannerMapper {

    /**
     * 添加一条新的轮播图数据
     *
     * @param banner 待添加的轮播图信息
     * @return 受影响的行数
     */
    int insert(Banner banner);

    /**
     * 查询所有轮播图
     *
     * @return 轮播图列表
     */
    List<Banner> findAll();

    /**
     * 查询所有有效的轮播图(在有效期之内或者长期有效的)
     *
     * @return 轮播图列表
     */
    List<Banner> findInvalidAll();

    /**
     * 根据轮播图ID获取轮播图详情
     *
     * @param id 轮播图ID
     * @return 轮播图详情
     */
    Banner findById(Long id);

    /**
     * 根据轮播图ID更新轮播图数据
     *
     * @param id     轮播图ID
     * @param banner 待更新的轮播图数据
     * @return 受影响的行数
     */
    int updateById(@Param("id") Long id, @Param("banner") Banner banner);

    /**
     * 根据轮播图ID更新轮播图数据
     *
     * @param id     轮播图ID
     * @param banner 待更新的轮播图数据 (为null的属性将被忽略)
     * @return 受影响的行数
     */
    int updateSelectiveById(@Param("id") Long id, @Param("banner") Banner banner);

    /**
     * 根据轮播图ID删除轮播图数据
     *
     * @param id 轮播图ID
     * @return 受影响的行数
     */
    int deleteById(Long id);
}
